home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 9 / Night Owl CD-ROM (NOPV9) (Night Owl Publisher) (1993).ISO / 006a / cdpro13.zip / CDPRO13.DOC < prev    next >
Text File  |  1993-03-02  |  21KB  |  455 lines
  1.  
  2.                                    CD-ROM PRO
  3.                  Librarian/File Manager for CD-ROM Collections
  4.  
  5.                                   Version 1.3
  6.  
  7.                                    SHAREWARE
  8.                               All Rights Reserved
  9.                             (c) 1993 Vince Sorensen
  10.  
  11.       This program is shareware. If you continue to use it past the 30 day
  12.                       evaluation period, you must register.
  13.  
  14. ───────────────────────────────────────────────────────────────────────────────
  15. Registration Fee:    $15.00 (U.S. or Cdn)
  16. Author Address:      Vince Sorensen                BBS Info:
  17.                      6 Armstrong Bay                  Superboard 1:140/121
  18.                      Regina, Sk., Canada              (306)789-8682
  19.                      S4N 4G7                          14400 v.32/v.42bis
  20. ───────────────────────────────────────────────────────────────────────────────
  21. Registered Users receive the latest registered version on diskette (see
  22. shipping notes below) or a registration key.
  23.  
  24. The registered version includes automated file listing import (searches CDs
  25. for FILES.BBS; IMPORT.CNF not necessary in many cases), sample IMPORT.CNFs
  26. for popular CD-ROMs, and extra utilities and reports.
  27. ───────────────────────────────────────────────────────────────────────────────
  28.  
  29. This program was written originally to keep track of what programs were on
  30. what CD-ROM, and to eliminate duplicate files on floppy. It allows the user to
  31. quickly find and view/run/copy any file on any CD-ROM, as well as reporting
  32. on duplication and/or unique files between CDs, whether in the user's
  33. collection or not. Text file format conversion is also supported, with
  34. the ability to fill in information found on the actual CD if it was not
  35. included in the text files originally.
  36.  
  37.  
  38.     Note: Pressing F1 gives context sensitive help wherever available.
  39.           The ESC key cancels most operations, and exits most screens
  40.           (without saving, where applicable).
  41.  
  42.  
  43. Quick Set-Up
  44. ────────────
  45.  
  46.     You should have a copy of CDP.EXE and CDP.HLP somewhere in your
  47.     path. The databases will be built in the current directory.
  48.  
  49.     To run this program:
  50.  
  51.     (1) You need text files containing the file listings for your CD-ROMs.
  52.     (2) Configure CD-ROM PRO File Manager to reflect your equipment
  53.         set-up, and use the "Format File Listings" option to enter the
  54.         format of the text files you will be importing (if not already
  55.         set up - some, such as PCBoard, already are). This means
  56.         checking the text files in (1) above, and noting the column
  57.         that the file name, date, size, and description information
  58.         begins in, and their length (in the case of the date, its format).
  59.         If a field is missing, set its column to zero. You can fill in
  60.         the date and size information later with the "Correct Date and
  61.         Size" function.
  62.     (3) If you will be importing a large number of text files, it is
  63.         recommended that you set up a file called "IMPORT.CNF" that
  64.         contains information on what CD and directory will be
  65.         imported, and which text file will contain the file names, etc.,
  66.         for that directory. The format of IMPORT.CNF is explained below
  67.         briefly, and in greater detail in the sample IMPORT.CNF enclosed
  68.         in this archive.
  69.         The "Import File Listings - Interactive" feature is more useful
  70.         for single directories, and novice users.
  71.     (4) Use one of the "Import File Listings" features to import the
  72.         information you require. This program will automatically detect
  73.         if one-line or multiple-line descriptions are being entered
  74.         (PCBoard or LongLine Formats Only).  The registered version
  75.         includes a feature that eliminates the need for IMPORT.CNF
  76.         with most CDs.
  77.  
  78.                             ─────────────────────
  79.  
  80.  
  81.  
  82. IMPORT.CNF File Definition:
  83. ───────────────────────────
  84.  
  85. Source File Listing        Size:  25            Location:    1 - 25
  86. CD Title                   Size:  15            Location:   26 - 40
  87. Format                     Size:  10            Location:   41 - 50
  88. Location                   Size:  32            Location:   51 - 82
  89. Title                      Size:  40            Location:   83 -122
  90. Subscription               Size:  15            Location:  123 -138
  91.  
  92. A sample IMPORT.CNF is enclosed in this archive for your convenience.
  93.  
  94. The fields are:
  95.  
  96. Source File Listing - path and filename of the FILES.BBS to be imported
  97. CD Title - Your choice of 15 letters to describe this CD
  98. Format - The format (PCBoard is the default) the FILES.BBS is in.
  99. Location - The location of the files that are described in the FILES.BBS
  100. Title - Your choice of 40 letters to describe the directory
  101. Subscription - The CD Title of the CD being replaced (I.E. A "Subscription"
  102.    of "Simtel 9/92" when the CD Title above is "Simtel 12/92" Means that if
  103.    the same file name is on both disks, the reference to it under Simtel 9/92
  104.    is deleted.
  105.  
  106.                             ─────────────────────
  107.  
  108.  
  109.  
  110. Keyboard Commands for Scrolling Tables
  111. ──────────────────────────────────────
  112.  
  113.    Press F1 when in a scrolling table for a complete command list.
  114.  
  115.    CTRL-V - View/Run highlighted file
  116.    ESC - Return to previous screen
  117.    ARROW DOWN - Highlight next file
  118.    ARROW UP - Highlight previous file
  119.    CTRL-S - Search for a phrase
  120.    CTRL-N - Next occurance of a phrase (specified by the last CTRL-S)
  121.    CTRL-X - Run DOS Command (on tagged files, if any; otherwise the
  122.       current highlighted file; see below)
  123.    SPACE BAR - Tag/Untag highlighted file
  124.    F10 - Clear all tags
  125.  
  126.  
  127.                             ─────────────────────
  128.  
  129.  
  130.  
  131. Searching for Phrases:
  132. ──────────────────────
  133.  
  134. (a) Basic
  135.    In it's simplest form, you just type in the phrase you want to scan
  136. the file names, dates, and descriptions (including extended descriptions) for.
  137.  
  138. (b) Wildcards
  139.    A '*' in the phrase indicates that you are entering two (or more) phrases,
  140. and that there can be any number of characters between the two phrases.
  141. A '?' indicates that there is 1 character between the two phrases, and a
  142. number of question marks indicate that there are a set number of characters
  143. between the two phrases. Both these wildcard symbols should work the
  144. same as they do in DOS.
  145.  
  146.    Examples:
  147.  
  148.       11/??/92*FIDO
  149.       will find the next file dated in November of 1992 and containing
  150.       the word FIDO in their descriptions. (Case is ignored)
  151.  
  152.       FIDO*PCB
  153.       will find the next file with both FIDO and PCB in their
  154.       name/description separated by 0-255 characters. Note that 'PCB'
  155.       *MUST* follow 'FIDO'. It cannot be before.
  156.  
  157.  
  158.  
  159. (c) Extended AND/OR
  160.    A '||' can be used to indicate an OR statement. A '&&' will indicate
  161. an AND. Note that neither can be combined with any other wildcard or
  162. extended search (I.E. This||That&&Another is invalid, and so is
  163. FIDO&&PCB*FOLLOWED). In these cases, the wildcard characters will be
  164. treated as ordinary characters.
  165.  
  166.    Examples:
  167.  
  168.       92&&FIDO
  169.       will find the next file with both a 92 and the word 'FIDO' in
  170.       its name description. In other words '1992 FidoNet' and 'FidoNet
  171.       1992' would both be found.
  172.  
  173.       92||FIDO
  174.       will find the next file with either a 92 or the word 'FIDO' in
  175.       its name description. In other words '1992', 'FidoNet', '1992 Fido',
  176.       and 'FIDO.ZIP...11/23/92' would all be found.
  177.  
  178. Note that these rules apply for both single file searches and the
  179. extended table searches.
  180.  
  181.  
  182.                             ─────────────────────
  183.  
  184.  
  185. Text File Viewing:
  186. ──────────────────
  187.  
  188.   CD-ROM PRO File Manager contains an internal file viewer, with Search
  189.   and Line Jump Functions. However, if you have another text file
  190.   viewer you prefer, you can specify it in the Configuration menu.
  191.   To return to using the internal viewer, specify INTERNAL or leave
  192.   the TEXT VIEWER line blank. Please note that the internal file viewer
  193.   tries to load the file into memory - if you are viewing files over
  194.   140K in size, it is recommended that you use an external viewer, such
  195.   as LIST. Please note that only the file you are highlighting when you
  196.   press CTRL-V will be viewed (and the files it contains, if it is
  197.   archived) - tagged files are only used when executing DOS commands
  198.   with the CTRL-X key (see below).
  199.  
  200.  
  201.                             ─────────────────────
  202.  
  203.  
  204. Executing Commands:
  205. ───────────────────
  206.  
  207. You have the option to execute a DOS command from within the program in a
  208. number of places by pressing CTRL-X. When you do, you'll be presented with
  209. the following screen:
  210.  
  211. ╔══════════════════════════════════════════════════════════════════════════════╗
  212. ║ EXECUTE COMMAND (up to 130 characters):                                      ║
  213. ║COPY C:\001A\42BOOT.ZIP                                                     ║
  214. ║                                                                              ║
  215. ║             ┌───────────────────────────────────────────────────┐            ║
  216. ║             │  Pressing CTRL-END clears to the end of the line  │            ║
  217. ║             │  Pressing ESC exits without executing command     │            ║
  218. ║             │  Pressing ENTER accepts and executes the command  │            ║
  219. ║             └───────────────────────────────────────────────────┘            ║
  220. ║                                                                              ║
  221. ║      ^    Indicates "Next command" (Divides multiple commands)               ║
  222. ║      ->   Indicates "Change to this directory before executing command"      ║
  223. ║      %TAG Indicates execute command for all tagged files                     ║
  224. ║      %FN  Indicates execute command on c:\001A\42BOOT.ZIP                    ║
  225. ║                                                                              ║
  226. ╚══════════════════════════════════════════════════════════════════════════════╝
  227.  
  228. ...and you can alter the command (between the symbols  and )
  229. however you wish, and then press ENTER to shell out to DOS and
  230. execute it. The default command is the one you specified in the
  231. Configuration screen, followed by the last path and file name
  232. referenced, unless you have tagged files, in which case the file
  233. name is replaced by %TAG.
  234.  
  235. In some areas, CTRL-C and CTRL-Z are also available. You are still
  236. presented with a default command, but CTRL-C will always begin with
  237. COPY instead of your default command, and CTRL-Z will begin with
  238. PKZIP instead of your default command. In addition, the default
  239. target directory you specified within Configuration will be appended
  240. to the end, following a "->". This way, you can copy, or even unzip
  241. the chosen file into a selected directory within a minimum of keystrokes.
  242.  
  243. Tagging notes:
  244.  
  245. Before calling the command screen, you may select (tag) files using the
  246. SPACE BAR. F10 will clear all tags. When entering commands, put
  247. %TAG where you would normally put the file path and file name. When
  248. the command is executed, the program will execute your command once
  249. for each tagged file, replacing the %TAG with the file path and name.
  250.  
  251. I.E.
  252. Below shows the results of pressing SPACE on INSTRUCT.ZIP and INSTRUC3.ZIP.
  253. The √ symbol shows that the file is tagged.
  254.  
  255. INSTRUCT.ZIP√    64234  01/01/93 Instructions for using this CD-ROM.
  256. INSTRUC2.ZIP    141434  01/01/93 Instructions for getting more CDs from us.
  257. INSTRUC3.ZIP√    25234  01/01/93 Advanced info for using this CD-ROM.
  258.  
  259. CTRL-X is pressed, and the following is entered:
  260. COPY %TAG \TEMP
  261.  
  262. The two tagged files are then copied into the \TEMP directory. Tags
  263. are cleared as the command is executed. If you have set "Prompt for
  264. CD change when executing commands on tagged files" (in CONFIGURATION)
  265. to "Y", you will be prompted before the first command is executed on
  266. each tagged file if the CD that the file is on is different than the
  267. last one accessed. At this prompt, you may choose to CANCEL by pressing
  268. the ESCAPE key. All remaining tagged files will REMAIN tagged, if you
  269. do this.
  270.  
  271.  
  272.                             ─────────────────────
  273.  
  274.  
  275. Program Parameters: Using one set of databases from any directory
  276. ─────────────────────────────────────────────────────────────────
  277.  
  278. If you wish, you can specify the path to the databases when you
  279. start the program. For example,
  280.  
  281. CDP C:\DATA
  282.  
  283. would look in the C:\DATA directory for all five of the databases.
  284. Please note that the import file information routine does
  285. NOT look at this path. C:\DATA\ and C: are also valid paths.
  286.  
  287. This way you can access your CD from any directory, and even use
  288. the current directory as a default to copy/unzip to.
  289.  
  290.  
  291.                             ─────────────────────
  292.  
  293.  
  294.  
  295. File Descriptions:
  296. ──────────────────
  297.  
  298. File descriptions are stored in a 1 line + 5 line format in order to save
  299. space... Since many CD-ROMs contain only 1 line descriptions, it would be
  300. wasteful to take up 6x48 bytes for every file's description when 48 would
  301. do. However, some CDs have PCBoard and 2 line style descriptions. This
  302. program determines if this is the case, and stores the 2nd and following
  303. lines in a special field that is only placed in records when necessary,
  304. saving the extra 240 bytes for each files with only a one-line description.
  305. On the tables of files shown in the program, only the first or first two
  306. lines are shown, and CTRL-D can be used to view the complete record.
  307. All searches check within the entire description, however.
  308.  
  309. Here's a sample screen of the extended description popped-up over the main
  310. file listing:
  311.  
  312. 42BOOT.ZIP       10210  4/08/92 Package th╔══════════════════════╗ot MS-DOS
  313.                                 MY CD-ROM ║ EXTENDED DESCRIPTION ║lternate Op. S
  314. 4CASE16.ZIP   ╔═══════════════════════════╝──────────────────────╢like case
  315.               ║ 42BOOT.ZIP       10210  4/08/92                  ║lternate Op. S
  316. 4DDBU512.ZIP  ║                                                  ║
  317.               ║ Package that allows you to dual boot MS-DOS      ║lternate Op. S
  318. 4DESC307.ZIP  ║ or DR-DOS easily using 4DOS' aliasing and INI    ║ber for
  319.               ║ (autoexecpath) capabilities to enhance /         ║lternate Op. S
  320. 4EDIT110.ZIP  ║ simplify booting up either operating system;     ║ creating &
  321.               ║ original config/autoexec are no longer used,     ║lternate Op. S
  322. 4LASER.ZIP    ║ so install programs which mangle... etc.         ║or sending
  323.               ║                                                  ║lternate Op. S
  324. 4LOGIC10.ZIP  ║ MY CD-ROM 7                                      ║ featuring
  325.               ║ 001A                                             ║lternate Op. S
  326. 4MICA25A.ZIP  ║ Alternate Op. Systems                            ║ll for
  327.               ║                                                  ║lternate Op. S
  328. 4PHONE.ZIP    ║         Press Any Key to Return to Table         ║along with
  329.               ╚══════════════════════════════════════════════════╝lternate Op. S
  330. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  331. ENTER to Change/View              ESC to Exit        CTRL-D Extended Description
  332. CTRL-S Search for Phrase          INSERT to Add               CTRL-X Execute Cmd
  333. CTRL-N Find Next Occurance        DELETE to Delete              CTRL-V View File
  334.  
  335.  
  336.                             ─────────────────────
  337.  
  338.  
  339. About File Listing Formats and Exporting File Listings:
  340. ───────────────────────────────────────────────────────
  341.  
  342. Using the Recreate File Listing option (also know as Create Listing of
  343. Files in a Directory) allows you to generate a formatted DOS file or
  344. printout of the list of files in a directory (not surprisingly!).
  345. All FILES.BBS file listings that are created using the "Re-Create/Print
  346. File Listings" option will use one-line descriptions, unless a "~", "|"
  347. is contained within the format name or one of the proprietary formats
  348. (described below - see "Format Conventions") is used.
  349.  
  350. Converting from a DOS file listing in one format to another will only
  351. convert the first line of each description, regardless of what multi-line
  352. options (as described below) are selected.
  353.  
  354. Format Conventions:
  355. ───────────────────
  356.  
  357. If the format title contains a "~" character, it indicates that the
  358. format is multi-line. The "~" should be followed by the number of lines
  359. of description allowed per file.
  360.  
  361.    I.E.:
  362.      MAXFMT~2 will output 2 line descriptions for each file.
  363.  
  364. If the format title contains a "|" character, it indicates that the
  365. description should be preceded by a "|". Note that the description
  366. is still placed at the position indicated in the format configuration.
  367. The "|" is placed two spaces before the description.
  368.  
  369. If both "|" and "~" are in the format title, the "|" is always placed
  370. before the 2nd and following lines, but only before the 1st line if
  371. the "|" precedes the "~".
  372.  
  373.     I.E.:
  374.        Taking the format "WILD" and simply changing the format name
  375.        has the following results:
  376.  
  377. If     WILD     outputs:      FILENAME.ZIP 91810 01-01-93  Description
  378.  
  379. then   WILD|    outputs:      FILENAME.ZIP 91810 01-01-93| Description
  380.  
  381. and    WILD|~2  outputs:      FILENAME.ZIP 91810 01-01-93| Description
  382.                                                          | Description Line 2
  383.  
  384. and    WILD~2|  outputs:      FILENAME.ZIP 91810 01-01-93  Description
  385.                                                          | Description Line 2
  386.  
  387. and    WILD~2   outputs:      FILENAME.ZIP 91810 01-01-93  Description
  388.                                                            Description Line 2
  389.  
  390. Also note that if there are not two spaces between the description and
  391. the previous field, and "|" is used, the previous field will be over-written.
  392.  
  393.  
  394.  
  395. Special Case (Proprietary Formats): If either the "PCBOARD" or
  396. "WILDCAT_2" file listing formats have been specified, special
  397. logic comes in to play to ensure the resulting FILES.BBS looks
  398. more like the proprietary formats used by these boards.
  399.  
  400. I.E.:
  401.  
  402. PCBOARD
  403. ARJ230.EXE    200363  02-07-92   This is what you'll use to extract files
  404.                                | that end in the ARJ extension. Its self-
  405.                                | extracting, so just type in ARJ230, and
  406.                                | then use the ARJ.EXE that comes out to
  407.                                | extract other files!
  408.  
  409. WILDCAT_2
  410. ARJ230.EXE    200,363   02/07/92 | This is what you'll use to extract files
  411. DwnLds: 3     DL Time   00:17:23 | that end in the ARJ extension.
  412.  
  413.  
  414.  
  415.                             ─────────────────────
  416.  
  417.  
  418. History:
  419. ───────
  420.  
  421. Version 1.3   Fixed bug FILE ALLOCATION ERROR bug due on systems with low
  422.               memory. Reduced memory requirements in general. Streamlined
  423.               floppy dupe checking, and changed tagged file command execution
  424.               to call a single batch file instead of re-shelling to DOS
  425.               for each file (in other words: DOS commands on tagged files
  426.               are faster!) Auto-import feature added to registered version.
  427.               Added Search for Phrase report to compliment existing Search
  428.               for Phrase tables and functions. Compare file lists and check
  429.               floppy for dupes routines now check extensions for "close"
  430.               matching - THIS.GIF now will not match THIS.ZIP. THIS.ARJ will
  431.               continue to match THIS.ZIP (Just checks for GIF/JPG extension
  432.               versus all others).
  433. Version 1.2   Enhanced search routines, and adjusted some overlays to reduce
  434.               memory requirements. CDP.HLP is now used instead of CD_PRO.HLP.
  435.               First Release through SDN
  436. Version 1.1d  Further refinements of the multi-CD players support. Selectable
  437.               drives instead of just A: for floppy dupe checking.
  438. Version 1.1c  Same as Version 1.1, except included upgrade package for some
  439.               users of Version 1.0.
  440. Version 1.1   Multi-CD Player support added.
  441. Version 1.0   First release, fixed minor bugs in beta
  442. Beta   0.97   First trial release.
  443.  
  444.                             ─────────────────────
  445.  
  446. Shipping Notes:
  447. ───────────────
  448.  
  449. Only the registration key will be sent unless shipping is prepaid.
  450. All shipping is through Canada Post/U.S. Mail unless other arrangements
  451. are made ahead of time with the author. Shipping to destinations within
  452. Canada is $2 extra. Shipping to destinations within the U.S. is $3. Other
  453. destinations depend on the cost of the carrier the registered user chooses.
  454.  
  455.